Skip to content

Implement PWA auto-update mechanism with service worker versioning - #16

Draft
tujii with Copilot wants to merge 5 commits into
masterfrom
copilot/fix-pwa-auto-update
Draft

Implement PWA auto-update mechanism with service worker versioning#16
tujii with Copilot wants to merge 5 commits into
masterfrom
copilot/fix-pwa-auto-update

Conversation

Copilot AI commented Dec 12, 2025 •
edited
Loading

Copy link
Copy Markdown
Contributor

PWA Auto-Update Implementation - Rebased on master ✅

Successfully addressed feedback: rebased on master, updated version, and added whatsnew entry.

Changes Completed:

  • ✅ Rebased on master (2b820fd) - No conflicts!
  • ✅ Updated version from 2.3.0+5 to 2.4.0+6 in pubspec.yaml
  • ✅ Updated CACHE_VERSION in web/flutter_service_worker.js to match (2.4.0+6)
  • ✅ Added whatsnew entry for PWA auto-update feature

Version 2.4.0 Release Notes:

PWA Auto-Update (Dezember 2025)

  • 🔄 Die App lädt automatisch die neueste Version ohne manuelles Cache-Löschen
  • 🎉 Update-Benachrichtigung: Freundlicher Banner "Neue Version verfügbar!" mit 5-Sekunden Auto-Reload
  • ⚡ Smarte Update-Checks: Automatische Prüfung beim Start, bei Sichtbarkeit und alle 30 Sekunden
  • 🗑️ Cache-Verwaltung: Alte Versionen werden automatisch aus dem Cache entfernt
  • 📱 Cross-Platform: Funktioniert nahtlos auf Web, iOS und Android

Technical Implementation

Multi-layered auto-update system:

  1. Service Worker (web/flutter_service_worker.js)

    • Version-based caching: angry-raphi-cache-2.4.0+6
    • Automatic old cache cleanup on activation
    • Immediate activation with skipWaiting() and clients.claim()

  2. PWA JavaScript (web/pwa.js)

    • Multi-trigger update detection (on load, visibility change, every 30s)
    • User-friendly German update banner with auto-reload
    • Service worker lifecycle management

  3. Flutter Integration (lib/main.dart)

    • Startup update check via _checkPwaUpdates()
    • Throttled checking (5-minute intervals)

  4. Cross-Platform Service

    • Platform-aware implementation using conditional imports
    • Web implementation uses dart:html for service worker API
    • Non-web stub for mobile/desktop platforms

Update Flow

App start → Check throttle → Trigger SW update → Detect new version → 
Show banner → Auto-reload (5s) → Clean old cache → Load new version

Users receive updates within 30 seconds of page visibility without manual intervention.

Files Modified:

  • pubspec.yaml - Version 2.4.0+6
  • web/flutter_service_worker.js - CACHE_VERSION 2.4.0+6
  • assets/whatsnew.md - Added PWA auto-update feature description
  • lib/main.dart - Added PWA update check on startup
  • web/pwa.js - Update detection and notification system
  • lib/services/pwa_update_service*.dart - Cross-platform update service
Original prompt

This section details on the original issue you should resolve

<issue_title>PWA lädt nicht automatisch die neuste version</issue_title>
<issue_description>PWA lädt nicht automatisiert die nächste Version. Daher muss ein sequentieller Check beim öffnen der app passieren, wenn die app gestartet wird. </issue_description>

Comments on the Issue (you are @copilot in this section)

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 4 commits December 12, 2025 12:50
@tujii
Add PWA auto-update mechanism with service worker versioning
979d4d9 
Co-authored-by: tujii <8914318+tujii@users.noreply.github.com>
@tujii
Fix platform-specific imports for PWA update service
266ffa5 
Co-authored-by: tujii <8914318+tujii@users.noreply.github.com>
@tujii
Address code review: Remove duplicate constants and add documentation
d0f80b3 
Co-authored-by: tujii <8914318+tujii@users.noreply.github.com>
@tujii
Add comprehensive testing guide for PWA auto-update mechanism
32b77e5 
Co-authored-by: tujii <8914318+tujii@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix PWA not automatically loading latest version Implement PWA auto-update mechanism with service worker versioning Dec 12, 2025
Copilot AI requested a review from tujii December 12, 2025 12:58
@tujii

tujii commented Dec 12, 2025

Copy link
Copy Markdown
Owner

@copilot rebase master and fix conflicts and add whatsnew and update version number

Copilot AI commented Dec 12, 2025

Copy link
Copy Markdown
Contributor Author

@copilot rebase master and fix conflicts and add whatsnew and update version number

Successfully completed all requested changes (commit 1a8e16c):

✅ Rebased on master - Branch is now based on origin/master (2b820fd)
✅ Updated version - Changed from 2.3.0+5 to 2.4.0+6 in pubspec.yaml
✅ Updated service worker - CACHE_VERSION now 2.4.0+6 to match
✅ Added to whatsnew.md - New section for Version 2.4.0 with PWA auto-update features

The branch needs a force push since history was rewritten during rebase. The changes are ready and all conflicts were resolved during the rebase process.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@tujii tujii Awaiting requested review from tujii

Assignees

@tujii tujii

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

PWA lädt nicht automatisch die neuste version

2 participants

@tujii